home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 26 / Cream of the Crop 26.iso / os2 / ctelo21.zip / readme.txt < prev    next >
Text File  |  1997-06-03  |  13KB  |  357 lines
  1.  
  2.  
  3.  
  4.                  ////// /////// ////// //  /////// ////// //
  5.                 //     //   // //  // //     //   //     //
  6.                //     /////// ////// //     //   ////   //
  7.               //     //   // //     //     //   //     //
  8.              ////// //   // //     //     //   ////// //////
  9.  
  10.                               Version 2.10
  11.  
  12.                    ISDN CAPI based Answering Machine
  13.                   for OS/2, Windows 95 and Windows NT
  14.  
  15.  
  16.  
  17.  
  18.  
  19.   Introduction:
  20.   ~~~~~~~~~~~~
  21.    CapiTel is a 32-Bit Answering Machine for OS/2, Windows 95 and Windows NT.
  22.    Graphical and Text-Mode Versions are available for all operating systems.
  23.  
  24.    Thanks to all the users who sent us their bug reports and feature ideas,
  25.    do not stop with your feedback!
  26.  
  27.    A special thanks goes to the following people:
  28.  
  29.      - Kerstin Glodzinski
  30.      - Norbert Schulze
  31.      - Kolja Nowak
  32.      - Peter Franken
  33.      - Dirk Schreiber
  34.  
  35.  
  36.   Main Features:
  37.   ~~~~~~~~~~~~~
  38.      - 32-Bit Multi-Threaded Answering Machine
  39.      - Graphical and Text-Mode versions for OS/2, based on CAPI 1.1
  40.      - Graphical and Text-Mode versions for Win 95/NT, based on CAPI 2.0
  41.      - Complete Support for .WAV-Files
  42.      - Remote Control Functions, controlled by DTMF tones.
  43.      - Silence Detection
  44.      - Completely configurable
  45.  
  46.  
  47.   Installation under OS/2:
  48.   ~~~~~~~~~~~~~~~~~~~~~~~
  49.    Before you are able to use CapiTel, you have to install the OS/2
  50.    Multimedia Package MMPM/2 and a CAPI 1.1 compliant driver for
  51.    your ISDN card.
  52.  
  53.    The installation itself is easy. Just unzip the complete distribution
  54.    archive into the desired destination directory and run INSTALL.CMD.
  55.    This REXX script will create a CapiTel object on your Desktop.
  56.  
  57.    If you are going to create CapiTel objects on your own, do not
  58.    forget to set the "Working Directory" !
  59.  
  60.    CAPI 1.1 is unable to handle more than one applications that listen on
  61.    the same EAZ. Therefore: If you use CapiTel, make sure it listens to
  62.    the configured EAZ alone.
  63.  
  64.  
  65.   Installation under Win 95/NT:
  66.   ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  67.    Unzip the distribution archive into a temporary directory and
  68.    start SETUP.EXE, this will install CapiTel on your machine and you
  69.    will find it in the Start-Menu.
  70.  
  71.  
  72.   Configuration:
  73.   ~~~~~~~~~~~~~
  74.    Use the Properties-Notebook to configure CapiTel.
  75.  
  76.  
  77.    General: - Play Ringing-WAV
  78.               If this item is selected, the Ringing-WAV is played on
  79.               your machine if an incoming call is detected.
  80.  
  81.             - Generate 16-Bit .WAV Files
  82.               Mark the checkbox if your soundcard supports this.
  83.  
  84.             - Restore Window on new Calls
  85.               If an incoming call is detected, the CapiTel window pops
  86.               to the front. Under OS/2, it doesn't steal the focus!
  87.  
  88.             - Confirm on Call-Deletion
  89.               Mark the checkbox if you want to be asked before
  90.               CapiTel deletes a call.
  91.  
  92.             - Ignore empty Calls
  93.               If you mark this checkbox, all calls with a recording
  94.               time of 0 seconds won't be recognized by CapiTel
  95.  
  96.             - Expand Area-Code
  97.               If a Caller-ID is detected that can't be found in the
  98.               Callers-Database, the name of the caller's city is shown.
  99.  
  100.             - DTMF Support
  101.               You can completely disable the DTMF Support (Remote Control)
  102.               with this item.
  103.  
  104.             - Answer Delay
  105.               Specify the default delay (in seconds) before CapiTel
  106.               answers a call.
  107.  
  108.             - Max. Recording Time
  109.               Specify the default maximum recording time (in seconds).
  110.               CapiTel automatically hangs up if a caller speaks and
  111.               exceeds this limit!
  112.  
  113.             - Silence Detection
  114.               Specify the Silence Detection (in seconds).
  115.               CapiTel automaticalls hangs up if a caller stops speaking
  116.               and exceeds this limit!
  117.  
  118.             - Welcome-WAV
  119.               The default file that is played when CapiTel answers a call.
  120.  
  121.             - Ringing-WAV
  122.               The default file that is played on your machine when an
  123.               incoming call is detected.
  124.  
  125.             - Logfile
  126.               CapiTel can log all calls into a log-file. You may also
  127.               specify a Named Pipe or a Device (ie. your printer), if
  128.               your operating system supports this.
  129.  
  130.  
  131.    Ports:   To edit, double-click on an entry or use the PopUp-Menu.
  132.             If there is no port listed, CapiTel reacts on ALL available ports!
  133.  
  134.             Port: A short description for the port.
  135.  
  136.             EAZ/MSN: The EAZ or the MSN for this port. If you are using
  137.                      a CAPI 1.1 driver, fill in an EAZ between 0 and 9
  138.                      here. If you are using CAPI 2.0, supply a complete
  139.                      MSN.
  140.  
  141.             Welcome WAV/ALW: The WAV or ALW file that is played to the caller.
  142.                              Use * for the default.
  143.  
  144.             Ringing WAV: The WAV that is played on your machine when
  145.                          an incoming call is detected.
  146.                          Use * for the default.
  147.  
  148.             Reaction: CapiTel is able to reject a call. Here you define how it
  149.                       should behave: 'Normal' for normal behaviour, 'Busy' to
  150.                       simulate a busy line, 'Refuse' to refuse the call, and
  151.                       'Unavailable' to simulate an unavailable service.
  152.                       Important: The reaction you define here is only valid
  153.                       for the ISDN card. If another device (ie. an ISDN
  154.                       telephone) is also listening on the EAZ/MSN, the caller
  155.                       won't get CapiTel's reaction!  There is nothing we can
  156.                       do about this. That's the way ISDN works.
  157.  
  158.             Answer Delay: The answer delay (in seconds) for the port.
  159.                           Use * for the default.
  160.  
  161.             Max. Recording Time: The maximum recording time (in seconds)
  162.                                  for the port.
  163.                                  Use * for the default.
  164.  
  165.  
  166.    Callers: To edit, double-click on an entry or use the PopUp-Menu.
  167.             If someone calls you and the incoming number matches one in this
  168.             container, the caller specific settings are used.
  169.  
  170.             Name: The caller's name.
  171.  
  172.             Number: The caller's number which is used when identifying
  173.                     incoming calls. You may use the * wildcard at the end of
  174.                     a number (and only there).. ie. 024192090* matches ALL
  175.                     numbers that start with 024192090.
  176.  
  177.             The other fields are described under Ports.
  178.  
  179.  
  180.    Remote Actions:
  181.             To edit, double-click on an entry or use the PopUp-Menu.
  182.  
  183.             DTMF Code: If this DTMF Code is detected, the appropiate
  184.                        Action is started.
  185.  
  186.             Action: The following actions are available:
  187.  
  188.                     - Remote Control plays all calls that have been
  189.                       recorded. Use the *-Button on your phone to delete
  190.                       them.
  191.                     - Reboot
  192.                     - Deactivate CapiTel
  193.                     - Quit CapiTel
  194.                     - Execute starts a program on your machine.  You have
  195.                       to fill in the Program, Arguments and Title fields!
  196.  
  197.             Window Title: This is the window's title of an EXECUTE-Action.
  198.  
  199.  
  200.    Use "Save" to save the new settings, or "Cancel" to discard them.
  201.  
  202.    A note about the Port/Caller specific settings:
  203.    If you specify something for a caller, it takes precedence over the
  204.    settings you might have defined for a Port.
  205.  
  206.  
  207.   Usage:
  208.   ~~~~~
  209.    The most important part of the CapiTel main window is the container. There
  210.    you will see all incoming calls. The fields are self explanatory.
  211.    Under OS/2, you may throw colours and fonts into the main window, they
  212.    will be remembered.
  213.  
  214.    If you are using CapiTel with hidden controls, you can access the various
  215.    menu functions with the popup menu you get when you click with your
  216.    right mouse button on the container. Under OS/2, the window can be moved
  217.    by dragging the sizing border with the right mouse button pressed.
  218.  
  219.    Use the "Record" option to record a new welcome message by calling
  220.    yourself. A dialog will pop up asking you for a filename. WELCOME.ALW is
  221.    the default. You can use the created ALW files in the Port and
  222.    Callers tabs of the Properties-Notebook.
  223.  
  224.    Of course you can create a .WAV file yourself and use it directly!
  225.  
  226.    If someone calls you and wants to stop the Welcome-WAV, he just
  227.    pushes the #-Button on his phone.
  228.  
  229.    If you have any questions, contact us!
  230.  
  231.  
  232.   Hints for Experts:
  233.   ~~~~~~~~~~~~~~~~~
  234.    Almost everything in CapiTel can be configured time-dependent. It can't
  235.    be found in the Properties-Notebook, because we didn't want to confuse
  236.    newbies. Edit CAPITEL.PRT, CAPITEL.NAM or CAPITEL.ACT and modify the
  237.    entries as follows:
  238.  
  239.      entry=<default_value>[~<chunk_1>][~<chunk_2>]...[~<chunk_n>]
  240.  
  241.      chunk_x=<fromday>-<today>,<fromtime-totime>,<value_for_this_chunk>
  242.  
  243.    fromday/today can be one of: Mo, Tu, We, Th, Fr, Sa, Su
  244.    Lower Day-Value must be first in the Day-Ranges. ie. Fr-Mo is not allowed!
  245.  
  246.    fromtime/totime must be xx:yy (xx=hours, yy=minutes) in 24 Hour format.
  247.  
  248.    CapiTel parses the chunks from left to right and stops after the first hit.
  249.    Time-dependent entries must not exceed 512 characters.
  250.    The default value is used if there is no hit.
  251.  
  252.     Some examples can be found in CAPITEL.CFG
  253.  
  254.  
  255.   Registration:
  256.   ~~~~~~~~~~~~
  257.    The OS/2 evaluation version expires after 60 days. After this period,
  258.    it _stops_ working and you have to register it if you want to
  259.    further use it.
  260.  
  261.    The Win 95/NT version does not expire, but it has a 10 second delay
  262.    upon Startup. Also reminding windows pop up after the fifth call,
  263.    and CapiTel automatically deactivates itself after the 12th call.
  264.  
  265.    Different BEEP-Tones are used by the registered version and the
  266.    evaluation copy. This way we can determine whether someone is using
  267.    an illegal copy or not.
  268.  
  269.  
  270.    Each CapiTel license costs 45.00 DM (German Marks). Contact us if you
  271.    want to organize a collective order with special prices!
  272.  
  273.    Your license will be valid for all versions.
  274.  
  275.    Fill out ORDER.TXT, and mail it to:
  276.     Carsten Wimmer
  277.     Freunder Landstr. 53a
  278.     D-52078 Aachen
  279.     Germany
  280.  
  281.    Or fax it to:
  282.     +49-241-9209026
  283.  
  284.    Or email it to:
  285.     cawim@pool.informatik.rwth-aachen.de
  286.  
  287.    Transfer the money, 45.00 DM (German Marks), to the following account:
  288.  
  289.     Volksbank Aachen Sued eG (Germany)
  290.     Account Number  : 22 00 47 30 20
  291.     Bank Code Number: 391 614 90
  292.  
  293.  
  294.   License Agreement:
  295.   ~~~~~~~~~~~~~~~~~
  296.    See LICENSE.TXT or LIZENZ.TXT (German Version) for details. By using
  297.    CapiTel you accept the License Agreement.
  298.  
  299.   The Mailing-List:
  300.   ~~~~~~~~~~~~~~~~
  301.    There has been an Internet Mailing-List set up for CapiTel, where you can
  302.    discuss bugs etc. with other users and the authors themselves.
  303.  
  304.    To subscribe, send an EMail to majordomo@sundancer.tng.oche.de and
  305.    put "subscribe capitel" (without quotes of course) in its body. To
  306.    unsubscribe at a later time, do the same with "unsubscribe capitel".
  307.    If you want to get more help, use "help" in the message's body.
  308.  
  309.    The address of the list is capitel@sundancer.tng.oche.de
  310.  
  311.  
  312.   Availability:
  313.   ~~~~~~~~~~~~
  314.    All CapiTel versions can be found here:
  315.  
  316.      - World Wide Web: http://www.oche.de/~cawim/capitel.html
  317.  
  318.      - BBS: Programmers' Heaven, +49-241-9519012 (Modem/ISDN), Area CAPITEL
  319.  
  320.      - FidoNet FileRequest: Zottelbox
  321.        Line 1  :  2:2432/518   VFC/V34/FAX      +49-5233-99527   2400-28800
  322.        Line 2+3:  2:2432/518   X75  (RINGDOWN)  +49-5233-99527   64000
  323.        Line 4  :  2:2432/519   V32bis           +49-5233-99528   2400-14400
  324.        Limits  :  50 Files / 4 MB                  NoReq.:  3:30-4:29 (ZMH)
  325.  
  326.        Magics  : CTELOS2  for the OS/2 GUI version
  327.                  CTELOS2T for the OS/2 Text-Mode version
  328.                  CTELWIN  for the Win 95/NT GUI version
  329.                  CTELWINT for the Win 95/NT Text-Mode version
  330.  
  331.  
  332.    You are explicitly allowed to distribute the unmodified CapiTel
  333.    ZIP-archive on the Internet, on Shareware CD-Roms, on Bulletin Board
  334.    Systems and so on.
  335.  
  336.  
  337.   Final Note:
  338.   ~~~~~~~~~~
  339.    Comments and Bug-Reports are welcome.
  340.  
  341.  
  342.  
  343.    Have fun,
  344.    the authors,
  345.  
  346.  
  347.               Werner Fehn           &           Carsten Wimmer
  348.  
  349.       werner@einstein.tng.oche.de     cawim@pool.informatik.rwth-aachen.de
  350.      http://www.diginet.de/~werner/        http://www.oche.de/~cawim/
  351.         FidoNet: 2:2433/626.4                 Fax: +49-241-9209026
  352.  
  353.           Schuttenhofweg 220                  Freunder Landstr. 53a
  354.             52080 Aachen                          52078 Aachen
  355.                Germany                               Germany
  356.  
  357.